


ZX SPECTRUM 
MONITOR 

AND 

DISASSEMBLER 


Crystal Computing 


CONTENTS 


Loading and running your Machine-code 


Monitor and Disassembler s-o Lakis ies Ki a ha 2 
Explanation of the commands 
PASSION saito 5 sa asi ai SS T tes Di a na das Date hye & 3 
Break: A aka a aaa ai ais a as Sieg ape S 4 
COPY i aaa area as Ne ra a da aaa ae LO a Sa da 5 
Disassemble £20. ia ed a sat a A 5 
Edit a ES A oan edie a A E S 6 
Find ico nid Sek Basta RO NO 7 
COOL a Ya CM MeN to A At S Pe tos Lo a 8 
Jump relative calculator ...........ooooooooooonornrrormo nooo.» 9 
Convert tai 9 
MESS A seed 10 
Prot iaa AS A AS OE RS 10 
Register: Display. orinando dla 10 
Substitute: an esm 4. hee eo ais a delas bs 11 
Tabūlatė': a e a a 12 
o iat eater ar e Cer Ok 12 
XIU) is areas a ant ie Aa tbe 12 
LEO | AST Gi bis A A tires O eaas 13 
Appendix One — Command list -cessere senres ossaa ean cece ee eee 14 
Appendix Two - ZX Printer. ......... e ee cece cee cee eee eens 15 





LOADING AND RUNNING YOUR MACHINE-CODE 
MONITOR AND DISASSEMBLER. 


v) 


Rewind the cassette to the beginning. 


Type LOAD “monitor16K” (16K version) 
or LOAD “monitor48K” (48K version) 
followed by ENTER 


When loaded, the program prints the message LOADED O.K. PRESS 


ANY KEY . When you press a key, you will return to BASIC, leaving 
Monitor and Disassembler safely above RAMTOP. 


to enter Monitor and Disassembler, type: 


PRINT USR 29369 (16K version) 
or PRINT USR 62137 (48K version) 


You will see the title page appear, along with the READY message, and 
flashing cursor. Pressing almost any key now will result in the command 
token word being displayed. Some of the commands will work without 
parameters (PRINT, EDIT, DISASSEMBLE), but most will return with 
the message PARAMETER ERROR. To find out how to use all the 
commands please read the next section. 


ASSIGN type ‘A’ 


l The ASSIGN command is used to alter the values which will be lo 
into the C.P.U. registers when, using the GOTO command, a machine- 
routine is next executed. 


: ASSIGN takes two parameters. The first is the register you wi: 
assign a value to. This may be any one of the following: 


A,B,C,D;E,H,L,BC,DE,HL,B”,C”,D”,E”,H”,L”,BC”,DE',HL”. 
The second parameter is the value to be given to the specified reg: 
and, like all numerical parameters, may be entered in either hexadecim: 
decimal form (decimal numbers must be preceded by a ‘£’ character). The 
parameters must be separated by an equals sign. 


GENERAL FORM OF THE COMMAND: 


ASSIGN register = value 


example: ASSIGN BC=£16514 


BREAK type ‘B’ 
The BREAK command sets a breakpoint at the address in RAM 


specified as its first parameter. 


A previously set breakpoint may be removed using the command 
BREAK O. A breakpoint is removed automatically when it is executed. 


example: BREAK 5000 


On encountering a breakpoint, the monitor displays the C.P.U. registers 
along with the menu: 


‘Q’-QUIT 


Entering: 


‘C’-CONT ‘M’-MONITOR 


‘Q? will return control to the monitor 
`C’ will continue execution of the machine code routine from the BREAK POINT 
`M’ produces the following reply: READY 
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In this mode, the machine code run may be continued from the 
BREAKPOINT even after memory and/or registers have been inspected and 
perhaps modified. When you wish to continue the run (or return to normal 
monitor mode) type ‘X’ (Exit). The register display is presented along with the 
Q/C/M menu. You may now proceed as though the BREAK had just been 
executed, ie. 


"O" — Return to monitor 
‘C’ — Continue run 
‘M’ — Re-enter special monitor mode to inspect/modify before continuing run. 


COPY type ‘C’ 


The COPY command moves a block of bytes from one locatio 
memory to another. 


COPY takes three parameters: 
i) the start address of the block to be copied from, 


ii) the finish address of the block to be copied from, 
iii) the start address of the block to be copied to. 


The three parameters must be entered in the order given ab. 
separated by full stops. Decimal and hexadecimal parameters may be mix. 
required, and the two blocks may overlap. 


GENERAL FORM OF THE COMMAND 
COPY start address 1.end address 1.start address 2 


examples: COPY 0.10.5000 ~~” copies 0-10 to 5000-5010 
COPY 5100.5200.5000 copies 5100-5200 to 5000-5100 
COPY 0.£500.£16514 copies 0-1 F4 to 4082-4176 


DISASSEMBLE type ‘D’ 


The DISASSEMBLE ‘command converts hexadecimal code 
standard Zilog Z-80 mnemonics. It takes one parameter, this being 
address to start disassembling from. Initially, 15 instructions are displayed, a! 


with the original hexadecimal bytes and the address of the instruction. To re: 
to command level, press ‘break’, any other key continues disassembly. 


example: DISASSEMBLE 02BB 


DIT type E? 


i ble ‘window’ into memory. On 
The EDIT command provides a mova 
ry to EDIT mode you will see displayed twenty addresses, and their contents 
both hexadecimal (right hand column) and character form. 


The contents of the address pointed to by the cursor may be altered 
iply by typing the new hexadecimal value. 


Other EDIT mode commands are: 
newline -scroll forwards by one byte 


J -jump backwards one byte 
Q’ -quit editing and return to command level 


EDIT takes one parameter, this being the address to start editing at. . 


ample: EDIT 5000 
mp EDIT £16530 





FIND type ‘F’ 


The FIND command finds all occurences of the string given as its third 
parameter, in the area of memory specified in the first two parameters. 


The first parameter is the address at which to start looking for the string, 
the second is the address at which to stop. The third parameter may be any one of 
the following: 


i) a single hexadecimal byte, 
ii) a string of up to seven hexadecimal bytes separated by full stops, 
iii) asingle decimal number in the range 0-255 preceded by a ‘£’ sign, 


iv) a string of up to four decimal numbers, each of which must be 
preceded by a “£” sign, separated by full stops, 


v) astring of up to twenty characters, enclosed in quotes, 


vi) any combination of the above 


GENERAL FORM OF THE COMMAND: 
FIND start address.finish address.string 


examples: FIND 0.100.C9 
FIND 0.100.2A.0C.40 ii. 
FIND 0.100.£201 
FIND 0.100.£42.£12.£64 
FIND 0.100. “HELLO” v. 
FIND 0.100.“CR”.3E.£51.“TAL” vi. 


:OTO type ‘G’ 


The GOTO command loads the C.P.U. with the values as displayed by 
+ REGISTERS command (see below), then executes machine-code from the 
idress given by its parameter. 

Return to command level is accomplished by the use of a RET 
struction at the end of the machine-code routine. 

If a breakpoint has been set, and is encountered, execution will be halted 
id the current register values displayed. For details, please refer to BREAK” 
»mmand. 


ample: GOTO 5000 


S] 


JUMP RELATIVE CALCULATOR type ‘J’ 


The JR command calculates the correct offset byte (the byte immediately 
following a JR or DJNZ instruction), given two parameters as follows: 


i) the address of the instruction, 


ii) the address of the instruction to be jumped to. 


example: 
Given the program below, the offset byte would be given by: 
JR 5012.5000 
the answer being OFFSET BYTE = EC 


5000 LD A.18 3E 18 
5002 . CALL 2BB CD BB 02 
5005 INC L 2C 

5006 CALL Z,4082 CC 82 40 
5009 LD (6000),HL 22 00 60 
500C SBC HL,DE ED 52 
500E RES 7.(HL) CB BE 
5010 BIT 1.L CB 4D 
5012 JR NZ,5000 207 


CONVERT  type“K” 


Converts between hex and decimal. CONVERT takes as its parameter 
any hex number in the range 0-FFFF, or any decimal number in the range 0- 
65535, giving as its result the corresponding decimal or hex value. 


example: CONVERT 5000 
=£20480 


{ESSAGE type ‘M? 


MESSAGE takes two parameters, the first being the address at which 
> string is to be inserted. The second parameter is the string itself which may be 
to nine characters in length, enclosed in string quotes. 


¡ENERAL FORM OF THE COMMAND: 


MESSAGE address “string” 
xample: MESSAGE 6000 “CRYSTAL” 


RINT type ‘P’ 


The PRINT command displays in character form the contents of any 64 
insecutive addresses in memory. The address of the first character is given by 
e first parameter. : 


ample: PRINT 2BB 


EGISTERS type ‘R’ 


The REGISTERS command displays the contents of the C.P.U. 
sisters in easy to read form. 


e registers displayed are: A,BC,DE,HL,BC’,DE’,HL’IX,IY,SP,(SP),(HL). 


The FLAGS register is displayed separately, allowing the inspection of 
ch flag. Any breakpoint set is also displayed. 
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SUBSTITUTE type ‘S’ 


The SUBSTITUTE command replaces all occurences of one byte 
within a block with another byte. The block to be searched is specified by the first 
two parameters following the command, these are, respectively, the start address 
of the block and the finish address. The third parameter is the byte to be replaced. 
the byte to replace it with must be given as the fourth parameter. 


example: 
SUBSTITUTE 5000.5 100.CD.CC 


replaces all occurences of the byte CD in the block 5000 to 5100 with the 
byte CC. . 
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R ‘7? 
ABULATE type “T' ZERO  type“Z 


The ZERO command sets all bytes in the specified block to zero. Its two 


The TABULATE command displays the contents of any 64 consecutive parameters are the start address and finish address of the bl 
dresses as hexadecimal bytes. The address of the first byte displayed is given A DE A 
the first parameter. example: ZERO 5000.5100 
ample: TABULATE 7E ‘ 


ERIFY type ‘V’ 


The VERIFY command compares two blocks in memory, returning with 

message ‘O.K.’ if they are equivalent. If two bytes are found which are not 

ual, the message ‘ERROR AT’, followed by the address in the second block at 
‘ich the error was found, is printed, and further comparison halted. - 


VERIFY takes three parameters, the first and second are the start and 
ish address of the first block. The third is the start address ofthe second block. 


ENERAL FORM OF THE COMMAND: 
VERIFY start address 1.finish address 1.start address 2 


ample: VERIFY 5000. 5100. 5200 


XIT type ‘X’ 


The EXIT command causes a return to the BASIC system. You may re- 
enter Monitor and Disassembler at any time using the BASIC command 
PRINT USR 29369 (16K version) 

or PRINT USR 62137 (48K version) 


PPENDIX ONE - LIST OF COMMANDS 


Y COMMAND 


ASSIGN 
-BREAK 
-COPY 
-DISASSEMBLE 
-EDIT 
-FIND 
-GOTO 


PARAMETERS 


REGISTER=VALUE 
ADDRESS 


START ADDRESS 1.FINISH ADDRESS 1.START ADDRESS 2 


address 

address 

START ADDRESS.FINISH ADDRESS string to be found 
ADDRESS 


-JUMP RELATIV Eaddress from.address to 


-CONVERT 


-MESSAGE 
-PRINT 
-REGISTERS 
-SUBSTITUTE 
-TABULATE 
-VERIFY 
-EXIT 

-ZERO 


NUMBER 

“ message "ADDRĖSS 

address 

no parameters 

“name” START ADDRESS.FINISH ADDRESS. BYTE I 
address 

start address 1.finish address 1.start address 2 


no parameters 
START ADDRESS.FINISH ADDRESS 


te: i) Parameters in capital letters must be entered. 


„BYTE2 


ii) Parameters in lower case may be omitted, and the last parameter input 
will be assumed. 
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APPENDIX 2 - ZX PRINTER 


The ZX Printer may be driven by entering CAPSHIFTed 1” after each of 
the following commands (and their parameters if required) and then pressing 
ENTER 


DISASSEMBLE 
FIND 

PRINT 
REGISTERS 
TABULATE 


The keyword LPRINT will appear after the command. 


Note: After a block has been disassembled to the printer, press ENTER for the 
next block or BREAK to return to the monitor. 


If BREAK is pressed whilst the printer is operating, then you will return to 
BASIC. Re-enter the monitor as usual. 
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